home *** CD-ROM | disk | FTP | other *** search
/ PC Zone 92 / DPPCZ0800.7z / DPPCZ0800.ISO / Patches / Star Trek - Armada / Armada_patch_1_1.exe / LDL / string.ldl < prev   
Text File  |  2000-05-05  |  19KB  |  454 lines
  1. ################################################################################################
  2. #    This is the LANGUAGE INDEPENDENT component of the LDL script.
  3. ################################################################################################
  4.  
  5. global_strings 
  6. {
  7.  
  8. ################################################################################################
  9. # INSTALLSHIELD SPECIFIC
  10. #
  11. #    "szRegGameKey" and "szRegProductKey" attributes have to be defined when patching a
  12. #    product that has been installed using InstallShield. These attributes should not be
  13. #    present for products installed, using the Activision Installer.
  14. #
  15. #    "szRegGameKey" is the name of the registry key under "HKEY_LOCAL_MACHINE\Software" that
  16. #    contains information on the product to be patched.
  17. #
  18. #    Example: string szRegGameKey "Activision\Battlezone"
  19. #
  20. #    "szRegProductKey" is the name of the registry key under
  21. #    "HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\App Paths" for this
  22. #    product.
  23. #
  24. #    Example: string szRegProductKey "bzone_exe"
  25. #
  26.  
  27. ################################################################################################
  28. # ACTIVISION INSTALLER SPECIFIC
  29. #
  30. #    "szLogfilePath" should only be defined for products that have been installed using the
  31. #    Activision Installer". This attribute specifies the name of the product's logfile
  32. #    relative to the product install directory and is only used when the user specifies the
  33. #    install directory (either by dragging and dropping a directory onto the Patcher EXE or
  34. #    by specifying the command line option "-here").
  35. #
  36. #    Example: string szLogfile "Uninstall\\Heavy Gear 2.log"
  37. #
  38.  
  39. #    string szLogfile "Uninstall\\Armada.log"
  40.  
  41. ################################################################################################
  42. # ACTIVISION INSTALLER SPECIFIC
  43. #
  44. #    "szUninstallKey" should only be defined for products using the Activision Installer.
  45. #    This attribute specifys the product's uninstall key under
  46. #    "HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall" and is only
  47. #    used if the product install directory needs to be determined via the registry.
  48. #
  49. #    Example: string szUninstallKey "Activision_HG2UninstallKey"
  50. #
  51.  
  52.     string szUninstallKey "Activision_StarTrekArmadaUninstallKey"
  53.  
  54. ################################################################################################
  55. #
  56. #    "szExePath" specifies the product's main executable, relative to the product install
  57. #    directory. This attribute is only used if the product install directory has been
  58. #    specified by the user (either by dragging and dropping a directory onto the Patcher EXE
  59. #    or by specifying the command line option "-here").
  60. #
  61. #    Example: string szExePath "bzone.exe"
  62. #
  63.     string szExePath "Armada.exe"
  64.  
  65. ################################################################################################
  66. #
  67. #    "szValidBranchLow" and "szValidBranchHigh" are an optional attribute pair that, allows
  68. #    the specification of a branch range, which this patch is to apply to.
  69. #
  70. #    If this attribute pair is defined and the product's "anet.inf" file contains a "Branch"
  71. #    key in the "[Version Info]" block, the Patcher checks if the product's current "Branch"
  72. #    number falls within the specified branch number range.
  73. #
  74. #    "szValidBranchLow" and "szValidBranchHigh" are inclusive. Thus the following mathematical
  75. #    relationship has to hold true, in order for the patch to be considered applicable:
  76. #    szValidBranchLow <= anet.inf.[Version Info].Branch <= szValidBranchHigh. If this does not
  77. #    hold true, the text specified by "szWrongBranch" attribute (usually defined in the
  78. #    language specific LDL) is displayed and the patching process is aborted.
  79. #
  80. #    Both of these attributes have to be specified together as a pair. If either one or both
  81. #    of these attributes is missing or the product's "anet.inf" does not contain a "Branch"
  82. #    key in the "[Version Info]" block, this test passes by default.
  83. #
  84. #    Example: string szValidBranchLow  "0.0"
  85. #         string szValidBranchHigh "2.4"
  86. #
  87.  
  88. ################################################################################################
  89. #
  90. #    "szValidPlatform_n" is an optional attribute and specifies one or more platforms, which
  91. #    this patch is to apply to. "_n" represents any unique and positive number. There can
  92. #    be multiple "szValidPlatform_n" as long as their indecis ("_n") are unique.
  93. #
  94. #    If one or more "szValidPlatform_n" are specified and the product's "anet.inf" file
  95. #    contains a "Platform" key in the "[ActiveNet]" block, the Patcher traverses through all
  96. #    "szValidPlatform_n" in an attempt to find one that matches the product's current
  97. #    "Platform" key. If no matching "szValidPlatform_n" is found the, text specified by
  98. #    "szWrongPlatform" is displayed and the patching process is aborted.
  99. #
  100. #    If no "szValidPlatform_n" was specified or the product's "anet.inf" file does not contain
  101. #    a "Platform" key (in the "[ActiveNet]" block), this test passes by default.
  102. #
  103. #    If one or more "szValidPlatform_n" attributes are specified, the language dependent
  104. #    LDL file(s) should specify the "szWrongPlatform" text string, so that the user can be
  105. #    notified if this test fails.
  106. #
  107. #    Example:    string szValidPlatform_0 "1"
  108. #            string szValidPlatform_2 "2"
  109. #
  110.  
  111. ################################################################################################
  112. #
  113. #    "szValidLanguage" is an optional attribute and specifies one or more languages, which
  114. #    this patch is to apply to.
  115. #
  116. #    If the number, specified by this attribute, is below 128, it is assumed to represent one
  117. #    language or a combination of multiple languages. Such a number can be created, by
  118. #    combining the bits of the desired languages via a "Logical Or". Since the bits of the
  119. #    current language codes do NOT overlap, the number may also be created by calculating the
  120. #    sum of the language numbers, that correspond to the languages that this patch is to
  121. #    support.
  122. #
  123. #    If the number is above 127, it is assumed to specify exactly one language.
  124. #
  125. #    For a number below 128, the Patcher compares (via a "Logical And") its bits to the bits
  126. #    making up the number stored in the "Language" key of the product's "anet.inf" file, under
  127. #    the "[ActiveNet]" block. If one or more bits match, the test is considered passed and the
  128. #    Patcher proceeds.
  129. #
  130. #    For a number above 127, the Patcher performs a simple equality test. If this number and
  131. #    the "Language" number (stored under the "[ActiveNet]" block in the "anet.inf" file)
  132. #    match, the test passes.
  133. #
  134. #    If these tests fail (the "Logical And" or the equality test), the Patcher displays the
  135. #    text specified by the "szWrongLocale" attribute (usually stored in the language
  136. #    dependent LDL script(s)).
  137. #
  138. #    Example: string szValidLanguage "1"
  139. #
  140.  
  141. ################################################################################################
  142. #
  143. #    "szQA_n" and "szQAout_n" are an optional string pair, where "_n" represents any unique
  144. #    and positive number. There can be multiple "szQA_n" & "szQAout_n" pairs as long as their
  145. #    suffixes are unique. The corresponding "szQAout_n" is optional - however, for each
  146. #    "szQAout_n" there has to be a corresponding "szQA_n". The Patcher checks for any "szQA_n"
  147. #    that matches the "QA" field in anet.inf (provided anet.inf contains a "QA" field, if
  148. #    there is a "szQA_n" that matches the "QA" field in the anet.inf file, the patch is
  149. #    considered applicable to the installed product. If this test passes and provided anet.inf
  150. #    contains a "QA" field, anet.inf's "QA" field is updated to the value specified by the
  151. #    "szQAout_n", whose suffix "_n" is the same as the "szQA_n" that matches the "QA" field
  152. #    currently stored in anet.inf (if the matching "szQA_n" has a corresponding "szQAout_n").
  153. #
  154. #    Example: szQA_0        "1190 German"
  155. #         szQA_5        "1140 German"
  156. #         szQAout_5    "1190 German"
  157. #
  158.     string szQA_0    "1867"
  159.     string szQAout_0    "2009"
  160.     string szQA_1    "1982"
  161.     string szQAout_1    "2009"
  162.     string szQA_2    "1983"
  163.     string szQAout_2    "2009"
  164.     string szQA_3    "2009"
  165.     string szQAout_3    "2009"
  166.  
  167. ################################################################################################
  168. #
  169. #    "szFromVersion" specifies the bottom range of product versions that this patch applies
  170. #    to (see also "szPatchVersion"). This number is compared to the build number stored in the
  171. #     "anet.inf" file, such as:
  172. #
  173. #    [ActiveNet]
  174. #    Version=36.4
  175. #
  176. #    The version number in "anet.inf" has to be greater than or equal to the number specified
  177. #    by this attribute. Use "0.0" if this is the first patch you are making for your product
  178. #    and/or want it to apply to any previously released versions of the product.
  179. #
  180. #    Example: string szFromVersion "15.7"
  181. #
  182.     string szFromVersion "0.0"
  183.  
  184. ################################################################################################
  185. #
  186. #    "szPatchVersion" specifies the top limit of product versions that this patch applies to
  187. #    (see also "szFromVersion") and updates the "[ActiveNet].Version" key in "anet.inf". The
  188. #    "[ActiveNet].Version" number in "anet.inf" has to be less than the number specified by
  189. #    this attribute. "0.0" is the minimum value and "255.255" is the maximum (as dictated by
  190. #    Activlink).
  191. #
  192. #    Example: string szPatchVersion "40.0"
  193. #
  194.     string szPatchVersion "49.0"
  195.  
  196. ################################################################################################
  197. #
  198. #    "szPlatform" can be used to change the value of the "[ActiveNet].Platform" key in
  199. #    the product's "anet.inf" file.
  200. #
  201. #    Example: string szPlatform "1"
  202. #
  203.  
  204. ################################################################################################
  205. #
  206. #    "szBranch" can be used to change the value of the "[Version Info].Branch" key in
  207. #    the product's "anet.inf" file.
  208. #
  209. #    Example: string szBranch "1.0"
  210. #
  211.  
  212. }
  213.  
  214. ############################################################################################################
  215. #
  216. #    this is the list of files to copy during install, not including those files automatically placed into
  217. #    uninstall/, and not including shortcuts (which are handled by the shortcut and start_menu blocks).
  218. #
  219. #    setup will first execute filecopy.copy_0, then filecopy.copy_1, and so on... up until the first block in
  220. #    this series which doesn't exist.
  221. #
  222. #    for each filecopy child block, the following attributes are defined:
  223. #
  224. #        src         path of the source files for this copy.  default directory is SRCDIR:/.
  225. #
  226. #        dest        path of the destination files for this copy.  default directory is TARGETDIR:/.
  227. #                        if src is not specified, dest is logged for uninstall, but nothing actually gets copied.
  228. #
  229. #        recurse        if present, filecopy searches recursively through all subdirectories of src.
  230. #
  231. #        update        can be one of two values, if present:  'version', or 'time'.  this means that no file gets
  232. #                        copied if the dest file already exists and is more recent.  If 'version', more recent
  233. #                        means a higher version number in the version resource.  Not all files have a version resource,
  234. #                        but all have a date and time stamp.  If 'time', more recent means a later 'last modified'
  235. #                        date & time.
  236. #
  237. #        shared        if present, files copied are treated as shared files, for which a reference count will be
  238. #                        maintained in the registry under the key, 
  239. #                        HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\SharedDLLs
  240. #
  241.  
  242. filecopy
  243. {
  244.         copy_0
  245.     {
  246.         string src "data"        
  247.         string dest "."
  248.             string recurse ""    
  249.     }
  250.       copy_1
  251.     {
  252.         string src "bzn"        
  253.         string dest "./bzn"
  254.             string recurse ""    
  255.     }
  256.       copy_2
  257.     {
  258.         string src "help"        
  259.         string dest "./help"
  260.             string recurse ""    
  261.     }
  262.       copy_3
  263.     {
  264.         string src "textures"        
  265.         string dest "./textures/rgb"
  266.             string recurse ""    
  267.     }
  268.       copy_4
  269.     {
  270.         string src "help2"        
  271.         string dest "./help/help"
  272.             string recurse ""    
  273.     }
  274.     copy_5
  275.     {
  276.         string src "missions"
  277.         string dest "./missions/"
  278.         string recurse ""
  279.     }
  280. }
  281.  
  282. ##########################################################################
  283. #
  284. #    The "shortcut" block is optional and consists of a list of child blocks, each describing
  285. #    a shortcut and referenced from the "start_menu"    block, which determines the
  286. #    directory/menu under which the shortcut is to be created.
  287. #
  288. #    Except for URLs, every shortcut that is created, will be opened using "slaunch.exe" -
  289. #    the shortcut launcher utility, which allows you to specify absolute paths to files on the
  290. #    product CD by using "CDDIR:/". If the shortcut uses "CDDIR:/", the user is prompted to
  291. #    insert the CD (which requires you to define the    "insertCD" attribute) if the file pointed
  292. #    to, is not found. Unfortunately this indirection through "slaunch.exe" causes problems
  293. #    with the associated shortcut icons. Therefore, for some of the shortcuts you will need
  294. #    to define the icon attribute. See below under "icon" for more information.
  295. #
  296. #    Since each shortcut is launched using "slaunch.exe", shortcuts are not checked during
  297. #    their creation and should be checked manually after the installation is complete.
  298. #
  299. #    The "slaunch.exe" utility is expected to reside in the uninstall directory relative to
  300. #    the product install directory. Unless you used the Activision Installer or you don't need
  301. #    to create shortcuts to files other than URLs, you will have to include
  302. #    "uninstall\slaunch.exe" in your patch.
  303. #
  304. #    The following "shorcut" attributes are supported:
  305. #
  306. #    name        The label of the shortcut. This refers to a text item in the
  307. #            "shortcut_strings" block in the appropriate language specific LDL file.
  308. #
  309. #    file        Specifies the path and filename of the file to be pointed to by this
  310. #            shortcut. If a relative path is specified, it is assumed to be relative
  311. #            to the product install directory. For absolute paths, you may use
  312. #            "CDDIR:/" (see above).
  313. #            If "file" has the special value "UNINSTALL", the contents that are
  314. #            generated for this field, point to the Activision Uninstaller, thus
  315. #            this value is only valid for products installed using the Activision
  316. #            Installer.
  317. #            This attribute may also specify a URL to a web page by having it begin
  318. #            with "http://". For this type of shortcut only the "name" and the "file"
  319. #            attributes are valid.
  320. #
  321. #    insertCD    Refers to a text string in the "global_strings" block. This text string
  322. #            should contain the product's name and is only used when    "CDDIR:/" is used
  323. #            in the "file" attribute and the file pointed to cannot be found. This
  324. #            text replaces the "%s" in the following string that would be shown:
  325. #            "Please insert your %s. Press OK when ready.".
  326. #
  327. #    options        (optional) The command line options for the file (usually only applies
  328. #            to executables) specified via the "file" attribute.
  329. #
  330. #    workingDir    (optional) The working directory for the file refered to by the "file"
  331. #            attribute (this usually only applies for executables). This can be a
  332. #            relative or absolute path. If a relative path is specified, it is
  333. #            assumed to be relative to the directory containing the file that is
  334. #            pointed to by the "file" attribute.
  335. #
  336. #    icon        (optional) The filename to the icon resource to use for the shortcut, if
  337. #            the file specified by the "file" attribute is not an EXE or DLL or if the
  338. #            DLL or EXE file pointed to does not contain an icon. You also need to
  339. #            specify    an icon, if the "file" attribute refers to a file, that contains
  340. #            its own icon (e.g. EXE or DLL) and is stored on a CD - otherwise windows
  341. #            would not know which icon to display when the CD was not inserted.
  342. #
  343. #    icon_number    (optional) The index of the icon to use in an icon resource with
  344. #            multiple icons. If the "icon" attribute is defined but the "icon_number"
  345. #            attribute is missing, an icon number of 0 is assumed.
  346. #
  347. #    Following is a list of icons, that are contained in the respective files and are assumed
  348. #    to be present for all 32-bit versions of windows:
  349. #
  350. #    icon file            icon number        description
  351. #
  352. #    WINDIR:/winhlp32.exe        1            purple help booklet
  353. #
  354. #    SYSDIR:/shell32.dll        0            unknown document
  355. #    "                1            generic document
  356. #    "                2            generic exe
  357. #    "                3            closed folder
  358. #    "                4            open folder
  359. #    "                7            removable drive
  360. #    "                8            fixed drive
  361. #    "                9            network drive
  362. #    "                11            cdrom drive
  363. #    "                12            dip integrated circuit
  364. #    "                15            computer
  365. #    "                16            printer
  366. #    "                17            network neighborhood
  367. #    "                22            finder find file
  368. #    "                23            purple help booklet (same as in winhlp32)
  369. #    "                25            sleepy monitor
  370. #    "                27            restart monitor
  371. #    "                28            shared icon suffix
  372. #    "                29            shortcut icon suffix
  373. #    "                31            empty trash
  374. #    "                32            full trash
  375. #    "                38            fonts folder
  376. #    "                40            audio CD
  377. #
  378. #    Note: Because internet shortcuts are not handled by slaunch.exe, you cannot specify an
  379. #    icon to use for them. They will use the default icon for the file type .url.
  380. #
  381. #    Example:
  382. #
  383. #    shortcut
  384. #    {
  385. #        play
  386. #        {
  387. #            string name "szPlay"
  388. #            string file "heavy gear 2.exe"
  389. #            string icon "gear.ico"
  390. #        }
  391. #    
  392. #        help
  393. #        {
  394. #            string name "szHelp"
  395. #            string file "readme.doc"
  396. #            string icon "WINDIR:/winhlp32.exe"
  397. #                
  398. #        }
  399. #
  400. #        uninstall
  401. #        {
  402. #            string name "szUninstall"
  403. #            string file "UNINSTALL"
  404. #        }
  405. #    } #(end shortcuts)
  406. #
  407.  
  408. ###########################################################
  409. #
  410. #    The optional "start_menu" block determines the directory/menu in which each shortcut,
  411. #    listed in the "shortcut" block is to be created.
  412. #
  413. #    You may use "START_MENU_PROGRAMS_DIR:/" for the "dir" attribute to specify the
  414. #    "Windows\Start Menu\Programs" folder (the actual path that "START_MENU_PROGRAMS_DIR:/"
  415. #    equates to, depends on where windows is    installed on the user's system).
  416. #
  417. #    For each block (the "start_menu" parent block and all child blocks), the following
  418. #    attributes are defined:
  419. # 
  420. #    dir        Path of the directory to create for this block.  Use "" to put the
  421. #            shortcuts in the same directory as the parent block (provided the "dir"
  422. #            attribute was specified for the parent block). If this directory path
  423. #            contains a drive specifier, it is considerd an absolute path. Otherwise,
  424. #            it assumed to be relative to the directory used by the parent block .
  425. #
  426. #    shortcut_n    Refers to a shortcut description in the "shortcut" block. The "_n"
  427. #            suffix should be a positive number and should also be unique within
  428. #            its block.
  429. #
  430. #    Note: Directories will only be created if they do not exist yet and if one or more
  431. #    shortcuts are placed into them - you cannot create a directory simply by specifying
  432. #    the "dir" attribute without a "shortcut_n" attribute.
  433. #
  434. #    Example:
  435. #
  436. #    start_menu
  437. #    {
  438. #        string dir "start_menu_programs_dir:/Heavy Gear 2 "
  439. #        string shortcut_0 "play"
  440. #        string shortcut_4 "uninstall"
  441. #        
  442. #        child0
  443. #        {
  444. #            string dir "Docs"
  445. #            string shortcut_0 "Help"
  446. #        }
  447. #    }
  448. #
  449.  
  450.  
  451.  
  452.  
  453.  
  454.